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This  document  is  one  of  a  series  of  TM-89O  volumes  established  for  Utility- 
System  Programming  proposals. 

Comments  on  this  document  must  be  recei-ved  by  29  March  1963  to  be  reflected 
in  the  final  design  criteria- 

Proposal  for  Additional  Features  in  the  LARII  Assembly  Program 
Processing  of  EQU  Cards 

Due  to  the  nature  of  the  present  LARII  assembler,  all  symbols  must  be  defined 
during  a  single  pass  through  the  source  program.  Since  EQU  cards  define  sym¬ 
bols,  they  must  be  coo^jletely  processed.  So  a  symbol  occuring  in  the  M-term 
of  an  EQU  must  be  defined  earlier  in  the  deck  than  the  EQU,  or  the  symbol  in 
the  location  of  the  EQU  will  be  undefined.  The  location  of  EQU  cards  in  a 
deck  then  is  dependent  on  the  symbol  ordering  of  the  program  Itself  e-ven  though 
EQU  cards  ha-ve  nothing  to  do  with  the  operational  part  of  a  program.  This  rule 
is  unnecessary  and  could  be  circumvented  in  the  following  way. 

When  the  assembler  finds  an  EQU  which  it  can  not  evaluate  it  would  sa-ve  the 
Infonnatlon  needed  in  a  table.  At  the  end  of  pass  one  edl  the  other  symbols 
in  the  program  except  possibly  some  of  the  EQU's  would  be  defined.  This  table 
would  then  be  scanned,  defining  all  of  the  symbols  possible.  VJhen  finedly  such 
a  scan  of  this  table  yielded  no  newly  defined  symbols,  the  rest  must  be  unde¬ 
fined.  With  this  feature  EQU  cards  could  be  placed  anywhere  in  the  deck  with¬ 
out  regard  to  the  location  of  the  symbols  which  are  contained  in  their  M-teim. 

Expanded  PUP  Pseudo 

The  DUP  pseudo  is  now  limited  to  duping  the  following  card  only.  This  capa¬ 
bility  could  be  expanded  to  allow  the  duplication  of  the  following  N  cards,  M 
times.  The  M-term  could  contain  two  expressions  separated  by  a  comma  to  define 
N  euid  M.  This  pseudo  coupled  with  the  VFD  pseudo  and  the  action  of  the  element 
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asterisk  in  M-term  arithmetic  would  allow  the  generation  of  almost  euiy  kind  of 
a  table. 

Additions  to  the  Index 

The  format  of  the  LARII  index  which  follows  the  listing  of  every  program  is: 

The  location  of  every  symbol  \diich  is  not  null,  followed  by  the  symbol  Itself 
(symbols  axe  in  alphabetical  order),  followed  by  the  location  of  each  cell  which 
makes  a  reference  to  this  symbol. 

Each  one  of  these  references  could  be  followed  by  a  comma  and  one  letter,  which 
would  give  some  sort  of  indication  of  the  operation  which  was  performed  on  the 
symbolic  cell  at  the  reference  location. 

The  letter  "L"  would  mean  that  this  cell  was  loaded  or  entered  into  one  of  the 
central  registers. 

The  letter  "D"  would  mean  that  this  cell  was  destroyed;  that  is,  changed  in 
some  fashion. 

The  letter  "T"  woifLd  mean  a  transfer  was  made  to  this  symbolic  location. 

The  letter  "U"  would  mean  the  cell  was  combined  with  a  central  register,  e.g., 

added. 

The  letter  "p"  would  mean  this  cell  was  used  as  a  machine  count,  e.g.,  shift 
instruction. 

The  letter  "B"  would  mean  this  cell  contained  a  symbolic  B-term  reference. 

The  letter  "Z"  would  mean  this  cell  was  referenced  by  a  ZRO,  NOP,  SVN,  or 

appears  in  a  pseudo  operation. 

All  EQU's  and  references  made  in  the  M-term  of  an  EQU  would  be  put  in  this 
index.  A  reference  made  by  eui  EQU  would  be  followed  by  an  asterisk  and  the 
letter  "E".  The  reference  location  would  be  the  location  counter  at  the  time 
the  EQU  was  encountered. 
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Each  symbol  defined  by  cm  BQLI  ccmd  would  be  put  In  the  Index.  The  symbol's 
value  and  not  Its  location  would  go  to  the  left  of  the  symbol.  An  asterisk 
would  appear  between  the  value  and  the  symbol.  She  value  In  the  first  refer¬ 
ence  location  would  be  the  location  counter  at  the  tine  the  EQU  was  encountered, 
followed  by  two  asterisks.  All  cells  idilch  referenced  the  symbol  would  follow 
In  the  usual  manner. 

At  present  null  symbols  are  in  a  separate  listing  and  their  locations  are  not 
given.  Null  symbols  could  be  Inserted  In  the  Index  along  with  their  location 
and  no  references,  of  course. 

Extended  Error  Checks 


Due  to  the  proposed  additions  to  the  assembly  program  the  error  checking  abili¬ 
ty  would  have  to  be  anqpllfled.  The  additional  error  flags  and  their  meanings 
would  be: 

"R"  error  -  This  M-teim  expression  is  neither  relocatable  nor  absolute  cmd 
would  not  be  handled  correctly  at  loeul  time.  An  exa>q>le  would 
be  A+B,  where  A  and  B  are  relocatable  elements.  The  M-texm  la 
clecured  to  absolute  zero. 


"C"  error 


Incorrect  iise  of  a  special  chsoracter  In  an  M-term.  The  M-term 
Is  cleared  to  absolute  zero  and  examination  of  that  card  ceases. 


"V"  error 


Division  by  zero  has  occured  In  an  arithmetic  expression.  It 
Is  eq,ulvalent  to  division  by  one. 


"R"  error 


The  symbolic  B-tezm  Is  undefined.  It  is  defined  eus  zero. 


"G"  error 


The  B-tezm  specified  Is  greater  than  seven.  It  is  calculated 
module  eight. 


"E"  error 


Too  many  tero^rarlly  undefined  EUQ  C8ad.s.  All  those  following 
must  remain  undefined.  The  limit  would  be  about  four  hundred. 
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"P"  error  -  A  pseudo  Instruction  such  as  DUP  or  BSS  has  a  relocatable  M-tem. 

It  is  defined  as  one.  This  error  printout  vlll  also  occur  If 
a  symbol  Is  undefined  vhen  It  Is  used  In  an  OBG,  CUP,  BSS,  but 
It  Is  defined  later.  The  OBG  will  get  a  value  of  lOOOOB.  The 
CUP  and  BSS  vlll  get  the  value  one.  nxe  symbol  vlll  be  defined 
correctly  and  used  as  It  Is  defined  If  It  Is  referenced  there¬ 
after. 

"T"  error  -  The  literal  table  la  full.  All  references  to  literals  vhich  do 
not  already  exist  In  the  table  must  go  undefined.  The  limit 
on  distinct  literals  Is  one  thousand  octals. 


"K"  error  -  A  reference  has  been  made  to  a  block  vhich  does  not  exist. 

The  share  area  Is  searched  (if  one  exists)  and  the  symbol  is 
undefined  if  it  is  not  found  there. 


The  number  of  errors  Is  printed  at  the  end  of  each  listing.  This  could  be 
foUoved  by  the  location  of  each  error  and  Its  type  In  a  format  similar  to 
a  symbol  In  the  Index.  The  number  of  errors  and  their  locations  (octal  cell 
In  the  program)  vould  be  apparent  at  a  glance.  The  location  of  the  sequence 
errors  could  be  recorded  In  this  manner  also. 


Reference  Symbols 

The  pseudos  REF,  REFD,  and  REFC  allov  one  to  alter  the  reference  symbol  table 
at  assembly  time.  If  prestores  are  stacked,  then  a  person  must  take  the 
symbol  table  as  It  remains,  foUovlng  the  previous  assemblies.  The  assembly 
program  Is  sure  to  have  the  original  table  only  vhen  It  Is  read  In  anev  from 
the  master  tape. 

The  original  table  could  be  saved  and  restored  before  assembling  the  next 
program  If  the  previous  program  alters  It.  In  this  vay,  one  vould  be  assured 
of  the  current  symbols  table  regardless  of  Job  stacking,  etc. 
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Heading  Cards 

The  first  two  REM  ctgrds  in  a  symbolic  deck  appear  at  the  top  of  each  page  of 
the  assembly  listing.  The  Identification  Information  (columns  JO-Bo)  on  these 
cards  Is  also  printed  on  each  page.  It  could  be  eliminated  since  It  serves  no 
real  purpose. 

Additions  to  OCT  amd  EEC  Pseudos 

The  lEC  pseudo  recognizes  the  letter  "D"  for  decimal  scaling  and  the  letter 
"B"  for  binary  scaling.  MTCII  recognizes  the  letters  "E"  and  "S"  respectively 
for  the  same  puirpose.  The  assembly  program  would  recognize  all  four  letter  In 
order  to  prevent  errors  resulting  from  confusion  of  the  two  programs . 

If  one  wishes  to  Inseirt  an  octal  number  In  the  higher  bit  positions  of  a  word 
using  the  OCT  pseudo,  he  must  follow  the  number  by  a  sufficient  number  of  zeros 
to  left  adjust  It  appropilately.  If  the  number  Is  not  to  be  left  adjusted 
by  a  multiple  of  three  bits,  zeros  are  not  sufficient  emd  the  bit  pattern  must 
be  considered  and  a  different  number  written  which  can  be  offset  by  a  multiple 
of  three  bits ^ resulting  in  the  desired  bit  pattern.  The  OCT  psei^  could  re¬ 
cognize  a  binary  scaling  factor.  Ihe  octal  Integer  would  be  followed  by  the 
letter  ”B''  and  this  followed  by  a  number  between  zero  and  forty-eight  to  specify 
the  number  of  bits  the  octal  integer  is  to  be  shifted  to  the  left.  The  binary 
scaling  factor  (which  follows  the  B)  would  be  a  positive  Integer  with  no  sign 


tem. 
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